home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / windows / swixo092.zip / README.TXT next >
Text File  |  1992-10-25  |  10KB  |  314 lines
  1. -------------------------------------------------------------
  2.                              swIXO
  3.                  by RTFM UN*X SOLUTIONS and
  4.                          beachSystems
  5.                         
  6.                         copyright 1992
  7.                Robert Swirsky and Steven Warner
  8.  
  9.  
  10. Swixo is designed to enable you to easily  and quicky
  11. send text messages to alpanumeric pagers.
  12.  
  13. Some paging systems disallow "manual" mode of page
  14. entry, only permitting IXO messages, presumably to discourage
  15. users from not using expensive messaging services.
  16.  
  17. Swixo uses IXO protocol, so you should be able to use
  18. it on any system.
  19. -------------------------------------------------------------
  20.                 
  21. 0. AS-IS, No Warranty, License to use.
  22.  
  23. Swixo belongs to RTFM UN*X solutions and beachSystems. You
  24. are granted a license to use the software, provided to do
  25. not modify anything, and you do not sell it.  You may
  26. distribute it to others, and are encouraged to do so.
  27. You may register with us for the enhanced version.
  28.  
  29. DO NOT modify the .ZIP file or the 'authenticity flags'
  30. will be reset.
  31.  
  32. Swixo is used entirely at YOUR OWN RISK. There is no warranty
  33. of any kind, either express or implied.  If any law excludes
  34. us from providing software to you in this manner, then the 
  35. license to use is VOID, and you must not use swIXO.
  36.  
  37. -------------------------------------------------------------
  38.  
  39. 1. SYSTEM REQUIREMENTS
  40.  
  41. swIXO will operate on any machine that is running Microsoft
  42. Windows, version 3.1.
  43.  
  44. swIXO requires a serial port, with a connected modem.  Some
  45. knowledge of your modems setup commands will be helpful.
  46.  
  47. -------------------------------------------------------------
  48.  
  49. 2. SOFTWARE INSTALLATION
  50.  
  51. The distribution disk contains a .ZIP file, which when UNZIPPED
  52. should have given an authenticity notice.  If it did
  53. not, then do not use swixo.  See #0 above.
  54.  
  55. To install swIXO, create a directory for swIXO on your hard
  56. disk, and copy the file swixo.exe, which was created from
  57. the .ZIP file
  58.  
  59. Start windows, and add swIXO to a program manager group, using
  60. NEW...
  61.  
  62. Start swXIO by double-clicking on the icon.  swIXO will automatically
  63. create the file SWIXO.IXO, which contains setup information
  64. and other runtime parameters.  You may delete the file SWIXO.IXO,
  65. to return swIXO to default settings later.
  66.  
  67. -------------------------------------------------------------
  68.  
  69. 3. GETTING GOING
  70.  
  71. swIXO requires a modem and serial port.  Modem cards should
  72. work okay, but are untested.  The free version of swIXO only
  73. supports COM1: and COM2:
  74.  
  75. The first time you run swIXO, you must use the SETTINGS...
  76. menu choice to define your system to swIXO.
  77.  
  78. The default settings should work okay.  If your modem has any
  79. funky strings that need be sent, then put them here.
  80.  
  81. When you are done with this screen, click OK.
  82.  
  83. RS-232 settings:
  84.  
  85.  Baud rate - Select the baud rate that swIXO should use to
  86.  talk to your modem.  If your modem uses a fixed DTE, then
  87.  go ahead and use 9600.  In this case you will need to add
  88.  commands to the dial string that tell your modem to dial
  89.  at 300 or 1200 baud.
  90.  
  91.  Most paging systems use 300 baud.  Some use 1200.  Experament
  92.  here and see what works best for you.
  93.  
  94.  Some paging system modems will get upset if your modem trys
  95.  to negotiate an error free connection, and/or compression.
  96.  (MNP3,4,5, LAP-M, V42.bis) etc..  You might have better luck
  97.  if you initially put strings to temporairly disable these 
  98.  features into the dial string.
  99.  
  100.  On a hayse modem this is commonly &Q0, and on a multi-tech
  101.  modem, use &E0.
  102.  
  103.  Word Length, Stop Bits, Parity.  Leave these at 7 bits, 1
  104.  stop bit and even parity.  This is what most paging systems
  105.  like to see.  These settings are provided in case your
  106.  situation is unusual.
  107.  
  108. Modem Control:
  109.  
  110.  RESET: The sequence of characters that swIXO needs to send
  111.  to get your modem to reset.  If you modem does not need to
  112.  be reset, or if dropping DTR will reset your modem, then
  113.  leave this field BLANK.  This text is automatically terminated
  114.  with a C/R.
  115.  
  116.  use a tilde  ~  to add a one second delay.
  117.  
  118.  If your modem becomes busy after sending reset or dropping
  119.  dtr, add tildes ~ to make swIXO wait for the modem to become 
  120.  ready again.
  121.  
  122.  DIAL PREFIX: The characters you want swIXO to send before the
  123.  telephone number in the dial string.  We use ATV1Q0 as a default,
  124.  which uses tone dialing, and verbose word responces.
  125.  
  126.  USE ATH0 TO HANGUP: Check this box if your modem will not hangup
  127.  upon loss of DTR.
  128.  
  129.  GIVE UP TIME: Put the amount of time that swixo should wait for
  130.  carrier, and the paging system.  40-60 seconds is about right.
  131.  
  132. Modem reply strings:
  133.  
  134.  CONNECT: The string your modem sends when it receives carrier.
  135.  
  136.  BUSY: The string your modem sends when the line is busy.
  137.  
  138.  FAIL: The string your modem send if it never gets carrier.
  139.  
  140. -------------------------------------------------------------
  141.  
  142. 4. SENDING PAGES
  143.  
  144. To send pages, make sure you did the SETTINGS... (#3) at least
  145. once since you installed swIXO.
  146.  
  147. On the swXIO main screen is a picture of an ADVISOR pager.
  148. Click anyplace on the pager to send a page.
  149.  
  150. The ENTER PAGE dialog will pop up, and provide you with some
  151. options.
  152.  
  153. The Message to send area is where you type the text that you
  154. want to be transmitted to the pager.  If you are sending to
  155. a POCSAG pager, you may use upper and lower case, along with most
  156. punctuation.  If your pager is GSC, you may use only UPPER
  157. case, and limited punctuation.
  158.  
  159. See appendix for pager identifications.
  160.  
  161. You may enter up to 199 characters into the message screen.
  162. Note: some paging systems may impose limits less than this.
  163.  
  164.  
  165. The PAGER ID box is where you put the digital address of tha pager
  166. you wish to transmit to.  Your paging company will provide you
  167. with this number.  Sometimes this number is identical to the
  168. telephone number used to send NUMERIC only pages to this pager.
  169.  
  170. PAGING SYSTEM PHONE #: This is the dial-in phone number that
  171. your paging service has provided to allow modem entry of alpha
  172. pages.  It is usually the same number for everyone on the system.
  173. Your paging company will provide this number for you.
  174.  
  175. PAGER TYPE POCSAG/GSC: Check the radio button indicating the
  176. type of pager you are sending to.  Use GSC if you don't know
  177. (or care).  If you want to use lowercase and punctuation, you
  178. might want to experament.  See the appendix.
  179.  
  180. CLEAR: Will erase the message text area.
  181.  
  182. SAVE DEFAULT:  Press this button to save the contents of this
  183. screen as the default.  Very handy if you send pages to the
  184. same person most of the time.
  185.  
  186. RECALL:  A cool, handy feature that will cause swIXO to fill
  187. out the ENTER PAGE screen in the same way as the last 10 pages.
  188. This will allow you review pages and send one again easily.
  189. try it!
  190.  
  191. CANCEL: Close this window and return to the main swixo screen.
  192.  
  193. OK, SEND PAGE: Swixo will send your page when you press this.
  194. You will see dialog messages that describe the process,
  195. and complain when something goes wrong.
  196.  
  197. When your page is accepted, swIXO will reply with 
  198. 'PAGE SUCCESSFUL'.
  199.  
  200. -------------------------------------------------------------
  201.  
  202. 5. PROBLEMS:
  203.  
  204. ---MODEM WON'T DIAL---
  205. Be sure you have used the settings screen to set up all
  206. RS232 parameters for your modem.  Be sire settings are
  207. correct, and that cables are Okay.
  208.  
  209. Be sure your RESET string has enough delay in it so that
  210. your modem is READY when dialing begins.
  211.  
  212. ---CANNOT LOG INTO PAGING SERVICE---
  213. Be sure you are using the correct paging system phone number.
  214.  
  215. Disable error correction and compression on your modem.
  216.  
  217. Try using 300 baud.
  218.  
  219. Your paging system may have a password on it.  Swixo does not
  220. support passwords in this release.
  221.  
  222. ---MODEM WON'T HANG UP---
  223. We strongly suggest you set your modem to hang up with DTR.
  224. If you absolutely cannot do this, check the   ATH0  box in
  225. the RS232 settings section of  SETTINGS...
  226.  
  227. ---PAGE IS INCOMPLETE---
  228. You may have a GSC pager, and are sending with POCSAG checked.
  229. Check the GSC button.
  230.  
  231. Your paging system may have the MAX character limit set to
  232. less than 199.  Send fewer characters.
  233.  
  234. -------------------------------------------------------------
  235.  
  236. A. Appendix A
  237.  
  238. GSC or POCSAG.
  239.  
  240.         GSC: Golay Sequential Code.
  241.  
  242.         POCSAG: Post Office Code Standard Advisory Group.
  243.  
  244.         (who thought of this stuff??)
  245.  
  246. It is difficult to tell which is better, GSC or POCSAG, unless
  247. you like reading UPPERCASE LETTERS and no punctuation.  GSC
  248. is UPPERCASE only, and seems to be popular with paging companies
  249. because it is faster to transmit in batch mode..
  250.  
  251. If you have a MOTOROLA ADVISOR, look on the back for the model
  252. number of your pager. It usually starts with A05 or A03.
  253. (A05 means 5-year warranty by the way, dunno anout A03).
  254.  
  255. The 8th character in your model number will tell you POCSAG/GSC..
  256.  
  257. Example:
  258.  
  259.         A03KLB5662AA
  260.                ^
  261.  
  262. If the 8th character is 3 or 9, POCSAG.
  263.                              6, GSC.
  264.  
  265. The example is a GSC pager.
  266.  
  267. -------------------------------------------------------------
  268.  
  269. B. TECH SUPPORT
  270.  
  271. Swixo comes with NO technical support.  We will however be
  272. happy to assist you by email with your problems or questions.
  273.  
  274. Since this is a beta release, your comments and input are
  275. particularly welcome.
  276.  
  277. Please email your technical questions and input to
  278. rtfm@boy.com
  279.  
  280. From compuserve:
  281. >INTERNET:rtfm@boy.com
  282.  
  283. -------------------------------------------------------------
  284.  
  285. C. Register!
  286.  
  287. If you would like to register your copy of swIXO, you may send
  288. $20 to:
  289.  
  290. S Warner
  291. RTFM/ BeachSystems
  292. 35451 Dumbarton Ct.
  293. Newark, CA 94560
  294.  
  295. Please email for availability
  296.  
  297. Registered users will receive the latest copy when available,
  298. and the enhanced copy when available.
  299.  
  300. The enhanced copy will have an improved page database,
  301. and pager management features such as ENABLE and DISABLE a
  302. pager.
  303.  
  304. -------------------------------------------------------------
  305.  
  306. D. MUMBO JUMBO
  307. Motorola and Advisor are trademarks of Motorola.
  308.  
  309. Microsoft, Microsoft Windows, MS Windows are trademarks
  310. of Mircosoft corporation.
  311.  
  312. -------------------------------------------------------------
  313.  
  314.